home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / grphme10.zip / DOCREAD.DOC < prev    next >
Encoding:
Text File  |  1992-11-23  |  3.1 KB  |  72 lines
  1.                     ┌─────────────────────┐
  2.                     │    Doc-Read 1.1     │
  3.                     │    by Tom Dibble,   │
  4.                     │  the tomster of wpi │
  5.                     └─────────────────────┘
  6.  
  7. USAGE:
  8.      DocRead [filename(s)]
  9.  
  10.      'filename' can include the DOS wildcards, '*' and '?', and
  11.      is by default the list:  "*.doc *.txt read*.*"
  12.  
  13. DETAILS:
  14.      Doc-Read is, as the name implies, a document reader (*.doc,
  15.      *.txt, readme, read.me ...) for inclusion with programs
  16.      which contain small ( < 600 lines) .DOC files.  It is meant
  17.      to replace the command string "type *.doc | more" by adding
  18.      a better interface, backwards-scrolling, search functions,
  19.      etc.  However, if you have '4-DOS' or an equivalent, I would
  20.      advise using the 'list' command, as it is far more versatile
  21.      and more functional than Doc-Read.
  22.  
  23.      Doc-Read is faster than most equivalents, but cannot handle
  24.      files larger than the free conventional memory space.  This
  25.      makes it ideal for viewing small files, but nearly unusable
  26.      for viewing large files.
  27.  
  28. SEARCHING:
  29.      Search-Mode is initiated with the '/' key (like in Emacs,
  30.      for UNIX users ... ), and is an 'incremental search' (i-
  31.      search).  What this means is that with each letter you type
  32.      in the search string, Doc-Read searches forward to the next
  33.      match, or tells you if there are no matches.  ^N (Ctrl +
  34.      'n') pushes Doc-Read to the next match of the input string.
  35.  
  36.      'Search-Mode' can be global, b-line, backwards, or (by
  37.      default) forwards.  Global (G) simply starts the search at
  38.      the head of the document.  b-line (L) will search for
  39.      matches at the beginnings of lines in the document, perhaps
  40.      indented or preceded by spaces. Backwards (B) will search
  41.      back from the top of the current page.  Forwards (any other
  42.      key) will search forward from the top of the current page.
  43.  
  44.      When a match is found, Search puts the top of the paragraph
  45.      in which the string was found at the top of the screen.  If
  46.      the found word is more than ten lines from the last
  47.      paragraph demarkation, the line containing the match is put
  48.      at the top of the screen.  To see exactly where on the
  49.      screen the match is located (or at least, which line), press
  50.      ^V for 'View'.  Continue your search as usual.
  51.  
  52.      Paragraphs are divided by lines which contain only
  53.      whitespace.  For instance:
  54.  
  55.           This is 'paragraph' considered two paragraphs
  56.  
  57.           by Doc-Read.
  58.      and
  59.  
  60.           These 'paragraphs' are considered one paragraph by Doc-
  61.           Read.
  62.           This is because There is no white space vertically
  63.           between the two paragraphs.
  64.  
  65. FINALLY:
  66.      Enjoy.  Doc-Read is free for anyone who wants to use it,
  67.      though I really can't imagine that happenning too often. 
  68.      This version (though perhaps not later versions) is
  69.      distributed in the Public Domain, and shall remain there
  70.      regardless.  I only ask that this file be included along
  71.      with the program.
  72.